查看原文
其他

EWSTM8系列教程02_新建基础软件工程

strongerHuang 嵌入式专栏 2021-01-31

置顶公众号,不错过每一条消息!


    本教程由作者strongerHuang于2018年07月更新。

版权所有:禁止商用

申明:该文档仅供个人学习使用,转载请公众号联系作者授权。


1写在前面

我们常说的IAR for STM8,其实指的就是EWSTM8,它的全称是IAR Embedded Workbench for STM8。


本文针对初学者,利用EWSTM8集成开发环境,基于STM8S标准外设库新建基础软件工程。(后面会讲述如何新建多工程、多目标)


本文分如下内容来讲述:

1.准备工作

下载安装EWSTM8

下载STM8标准外设库

整理工程文件夹


2.新建软件工程

创建工程

添加文件

配置工程


  为了方便大家平时公交、地铁、外出办事也能用手机随时随地查看该教程,本文章收录于【EWSTM8系列教程】,在微信公众号回复【EWSTM8系列教程】即可查看。


2

准备工作

俗话说“磨刀不误砍柴工”,做好了准备工作,后面新建基础软件工程的工作就很容易实现了。


2.1 下载安装EWSTM8

详情请参看该系列教程上一篇文章【EWSTM8系列教程01_IAR介绍、下载、安装和注册】。


2.2 下载STM8标准外设库

本文基于STM8标准外设库(STM8S_StdPeriph_Lib)来新建基础软件工程,所以需要下载标准库。如果你不使用标准外设库(如:使用寄存器)开发,本节内容可以略过。


A.官网下载

https://www.st.com/content/st_com/en/products/embedded-software/mcus-embedded-software/stm8-embedded-software/stsw-stm8069.html


提示:在官网下载需要登录账户,如果嫌麻烦可以在ST中文网,或下面百度网盘下载(和官网一样)。


B.百度网盘

http://pan.baidu.com/s/1qYbBKMK


提示:如果以上链接失效, 可以关注微信公众号, 获取更新链接。(微信公众号不支持外链接,请复制网址在浏览器打开)。


2.3 整理工程文件夹

这一小节的内容可根据自己习惯来整理,我整理的文件及文件夹结构是按照常规的整理方式。你如果觉得合理,可以直接引用;如果觉得不习惯这个结构方式,可以自己整理。


本节所讲述的文件夹及里面的内容不是本文新建软件工程的重点,若需要详细了解库文件、文件夹及里面源代码内容,可以参看我的另一教程【STM8S标准外设库教程】。


A.新建工程文件夹

首先建立一个存放工程文件的文件夹:STM8S_Demo


B.提取ST标准外设库文件

解压下载的标准外设库(STM8S_StdPeriph_Lib)可以看见下面四个文件夹和参考资料:

_htmresc:图片文件夹(不提取)

Libraries:标准驱动库(提取大部分

Project: 示例工程(提取少部分

Utilities:公共代码、评估板代码(不提取)

MCD-ST Liberty:软件许可协议(不提取)

Release_Notes:发行说明

stm8s-a_stdperiph_lib_um:库说明文档


ST官网下载的标准外设库里面有很多例程源代码和其他文件,但我们主要使用Libraries目录下STM8S_StdPeriph_Driver源代码,其他参考文件用于开发学习时参考使用。

1.拷贝Libraries文件夹到我们的STM8S_Demo工程文件夹下面。


2.拷贝STM8S_StdPeriph_Lib \ Project \ STM8S_StdPeriph_Template下面stm8s_conf.h、stm8s_it.c和stm8s_it.h三个文件到我们STM8S_Demo\App下面。


C.新建文件夹和文件

除了标准外设库文件之外,我们需要新建存放自己代码的文件和文件夹。我这里主要需要新建4个文件夹:

App: 应用程序代码

Bsp: 底层驱动代码

Doc: 说明文档

Project:工程文件


在自己新建的文件夹下面还需要新建自己的文件,文件里面添加必要的源代码文件。我提供的Demo工程,实现的功能比较简单,就是一个LED闪烁。本文重点讲述建立工程的过程,这里不描述源代码,具体可以自己下载查看。


上面几个步骤完成之后,我们就可以看到在工程文件夹“STM8S_Demo”下面整理的文件夹(如下图):

至此,准备工作算完成了,上面提取的文件、新建的文件里面具体的内容请下载Demo工程查看(文末下载)。


3下载

新建一个简单、基础的软件工程大概需要有三个步骤:创建工程、添加文件和配置工程。


上面的准备工作做好之后,就可以在Project文件夹下新建自己的软件工程了,下面将一步一步讲述从零开始新建一个软件工程的详细过程。


3.1 创建工程

创建工程:就是新建工作空间及工程,步骤比较简单。


A.打开软件,新建工作空间(File -> New Workspace)


B.新建工程(Project ->Create New Project)


C.创建一个空工程


D.选择保存路径、名称


E.空基础工程


F.保存工作空间(File -> Save Workspace)


至此,一个空的基础工程就创建好了,需要进一步添加文件到工程和配置工程。


3.2 添加文件

准确的来说,是在上面创建的空工程中添加组(文件夹)和添加源代码文件。简单的说,就是将你自己的源代码文件(前面提取的库、新建的文件等)添加到工程中。


这里的工程项目管理可根据自己的想法来定义(类似于自己分类、命名文件夹和文件),我这里按照常规的方式进行管理项目。


为了方便大家理解,我们单级目录方式分组,先在工程中添加组,再在组中添加源代码文件。


A.工程中添加组


B.填写组的名称


C.组中添加文件


D.按住Ctrl,鼠标选中要添加的文件


E.重复上面4个步骤,直到添加完成


3.3 配置工程

配置工程对于初学者来说,大部分内容只需要默认即可,这里只讲述几个常见的配置,能满足基本的功能。更多配置将在该教程后面的文章中讲述。


A.进入配置选项


B.选择器件


C.库配置Library Configration

如果需要使用某些标准的库函数接口(如我们使用的printf 、scanf),就需要选择Full(见下图)。


D.预处理Preprocessor(添加路径)

添加的路径最好是相对路径,而不是绝对路径。使用绝对路径工程位置改变之后就找不到文件,就会出错。


1.可以点击按钮选择路径;

2.或者通过复制文件路径进行配置。

·

·

·

·

·

·

直到完成


E.预处理Preprocessor(预定义)

这里的预定义类似于在源代码中的#define xxx 这种宏定义。这里的STM8S103可以在stm8s.h中打开即可。


F.输出Hex文件

很多初学的朋友都会问怎么输出 Hex( 可直接下载的程序文件),只需要按照下面配置即可输出Hex文件。


G.选择下载调试工具

根据自己情况选择的下载调试工具。


至此,一个基本工程的配置算完成了。如果源代码正确,就可以编译、下载、调试了。


4下载

1.STM8标准外设库百度网盘下载地址:

http://pan.baidu.com/s/1qYbBKMK


2.本文完整代码工程(可运行)下载地址:

链接:

https://pan.baidu.com/s/1MyAOZcOn04AnRq8zNZrL6w

密码:3lkl


提示:如果下载链接失效, 可以关注微信公众号, 获取更新链接。


5说明

1.该文档仅供个人学习使用,版权所有,禁止商用。


2.本文主要针对个人学习使用的朋友,若你是商业用途,建议购买正版软件。


3.上述内容仅供参考,如有不正确,或不清楚的朋友可以微信公众号联系我。


6最后

若觉得文章好,记得点赞、分享。扫描下面二维码、关注,在底部菜单中查看更多精彩内容!

长按识别图中二维码关注

    您可能也对以下帖子感兴趣

    文章有问题?点此查看未经处理的缓存